[AWS IoT TwinMaker] AWS IoT SiteWiseのアセットを自動で同期できるようになりました

若槻龍太

2022.12.28

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

こんにちは、CX事業本部 IoT事業部の若槻です。

先日（12/8）のAWS IoT TwinMakerアップデートで、AWS IoT SiteWiseのassetをTwinMaker workspaceにentityとして自動同期できるようになりました。

AWS IoT TwinMaker launches asset synchronization with AWS IoT SiteWise

これにより、SiteWise側でassetを作成した際に、TwinMaker側に逐一手動で対応するentityを作成する作業が不要となります。

やってみた

AWS IoT TwinMaker workspeceとAWS IoT SiteWise asset modelは、下記で作成済みのものを使用しました。

AWS IoT TwinMakerとIoT SiteWiseで風力発電タービンのデジタルツインを作成してみた | DevelopersIO

AWS IoT SiteWiseとのasset同期を有効化する

AWS IoT SiteWiseにはassetWindmill001が作成済みです。

AWS IoT TwinMaker Settings コンソールにアクセスし、[Model Sources]タブで[Connect workspace]をクリック。

AWS IoT SiteWiseと接続したいworkspaceを選択し、[Go to workspace]をクリック。

AWS IoT TwinMaker workspaceに接続するソースとしてAWS IoT SiteWiseを指定し、接続に使用するIAM Roleとして次のpermissonが付与されたroleを指定して、[Add Srouce]をクリック。

// trust relationships
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                 "Service": [
                    "iottwinmaker.amazonaws.com",
                    "iotsitewise.amazonaws.com"
                ]
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

// permissions
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iottwinmaker:*",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iotsitewise:Describe*",
                "iotsitewise:List*"
            ],
            "Resource": "*"
        }
    ]
}

これでWindfarm workspaceにAWS IoT SiteWiseをソースとするentity model sourceを追加できました。追加直後なので[Status]がCREATINGとなっています。

1分ほど待つとINITIALIZINGに変わりました。

さらに待つとentity model sourceのStatusがACTIVEとなりました。

entity一覧を見ると、SiteWiseに作成されていたassetが自動同期で作成されました。

entity model source作成後に、SiteWiseに2つ目のassetを追加で作成してみます。

すると2つ目のassetのentityも自動で作成されました。

逆にSiteWiseでassetを削除した場合はどうでしょう。

削除も問題なく同期されました。

注意点

IAM Roleの権限が不足している場合はエラーとなる

作成したentity model sourceのStatusがINITIALIZINGからなかなか変わらなかったため、詳細を見るとエラーとなっていました。

{
  "code": "ERROR",
  "message": "An error occurred when creating componentType: User: arn:aws:sts::XXXXXXXXXXXX:assumed-role/twinmaker-workspace-windfarm-XXXXXXXXXXXX-iad/AWSIoTTwinMaker is not authorized to perform: iottwinmaker:CreateComponentType on resource: arn:aws:iottwinmaker:us-east-1:XXXXXXXXXXXX:workspace/Windfarm because no identity-based policy allows the iottwinmaker:CreateComponentType action"
}

この時の原因はIAM Roleのpermissionで次の権限の記述が漏れていたためでした。

        {
            "Effect": "Allow",
            "Action": "iottwinmaker:*",
            "Resource": "*"
        },

AWS IoT TwinMaker Settings コンソールに戻り、[Model Sources]タブで[Disconnect workspace]をクリック。

[Disconnect]をクリック。

しばらく待つと[Connector status]がDISABLEDとなるので、permissionを修正したIAM Roleを使用してentity model sourceを再作成します。

同じ名前のEntityが作成済みの場合もエラーとなる

同じ名前のentityがworkspaceにすでに作成済みの場合も、entity model sourceの接続がエラーとなりました。

{
  "code":"ERROR",
  "message":"An error occurred when creating entity: Entity with name Windmill001 already exists under entity $ROOT in workspace Windfarm."
}

workspaceから重複しているentityを削除します。

削除後にしばらく待つとentity model sourceのStatusがACTIVEとなりました。

また重複エラーとなっていたentityが自動同期で改めて作成されました。

すでに手動作成されたSiteWiseのassetがentityとして作成済みの場合は、entityを一度削除する必要があるようなので要注意ですね。